agentful 0.4.14 → 0.4.15

package/README.md

@@ -26,7 +26,7 @@ agentful open               # open the preview
 | `login` / `logout` / `whoami` | Browser-based sign-in; the token is kept in the macOS Keychain (on Linux: a `0600` file under `~/.config/agentful/`) |
 | `init [--link <id>] [--title <t>]` | Create a cloud project or link an existing one (`.agentful/project.json`) |
 | `push [--prebuilt [--dir <path>]]` | Upload the source and build in the cloud; `--prebuilt` uploads a local build |
-| `push --dry-run [--json]` | Analyse what a push would upload and what would block it — uploads nothing |
+| `push --dry-run [--json [--summary]]` | Analyse what a push would upload and what would block it — uploads nothing |
 | `open` | Open the live preview |
 | `share [--private]` | Make the preview public, or private again |
 | `publish <subdomain>` | Publish at `https://<subdomain>.agentful.page` |
@@ -39,6 +39,9 @@ agentful open               # open the preview
 
 Inside the interface, `/` lists the Agentful commands (`/setup`, `/push`,
 `/preview`, `/publish`, `/share`, `/status`) alongside the built-in ones.
+`/push` checks before it uploads: the agent reads the same analysis as
+`push --dry-run`, explains what would block the upload or go missing on the
+site, and asks you before it changes a file or pushes.
 
 `push` respects your `.gitignore` and always excludes `.git`, `node_modules`,
 build output and every `.env` file. A push carries at most about 4.4 MiB
@@ -51,7 +54,8 @@ and what is left out, the largest files, identical copies, media embedded in
 HTML, and every reason the upload would be rejected. It uploads nothing,
 creates no project and changes no file; it exits with 1 when the push would be
 blocked. `--dry-run --json` prints the same analysis as one JSON document
-(`"schema": "agentful.push-analysis"`) for scripts and agents.
+(`"schema": "agentful.push-analysis"`) for scripts and agents; with `--summary`
+it leaves out the list of every file and keeps totals, limits and findings.
 
 ## What you can deploy
 

package/dist/index.cjs

@@ -3044,7 +3044,7 @@ var VERSION, brand, useColor, wrap, paint, tuiDesign, sym, ui;
 var init_branding = __esm({
   "src/branding.ts"() {
     "use strict";
-    VERSION = "0.4.14" ? "0.4.14" : null.version;
+    VERSION = "0.4.15" ? "0.4.15" : null.version;
     brand = {
       name: "agentful",
       // the command users type
@@ -6606,6 +6606,7 @@ function failedAnalysis(mode, projectDir, blocker) {
     schema: ANALYSIS_SCHEMA,
     schema_version: ANALYSIS_SCHEMA_VERSION,
     cli_version: VERSION,
+    view: "full",
     mode,
     root: null,
     ok: false,
@@ -6911,6 +6912,7 @@ function analyzePush(options) {
     schema: ANALYSIS_SCHEMA,
     schema_version: ANALYSIS_SCHEMA_VERSION,
     cli_version: VERSION,
+    view: "full",
     mode,
     root: rootDir,
     ok: blockers.length === 0,
@@ -6947,6 +6949,81 @@ function analyzePush(options) {
     fingerprint: `sha256:${fingerprint}`
   };
 }
+var SUMMARY_LISTS = {
+  largest_files: 8,
+  by_top_level: 8,
+  duplicates: 8,
+  duplicate_paths: 8,
+  embedded_media: 8,
+  entry_candidates: 20,
+  excluded_entries: 30,
+  dropped_by_platform: 20,
+  finding_paths: 8
+};
+var SUMMARY_MAX_BYTES = 24 * 1024;
+var printAnalysis = (analysis) => `${JSON.stringify(analysis, null, 2)}
+`;
+function summarize(analysis, divisor) {
+  const shortened = {};
+  const cut = (name, list, cap, alreadyOmitted = 0) => {
+    const keep = Math.max(1, Math.floor(cap / divisor));
+    const omitted = Math.max(0, list.length - keep) + alreadyOmitted;
+    if (omitted > 0) shortened[name] = (shortened[name] ?? 0) + omitted;
+    return list.slice(0, keep);
+  };
+  const finding = (kind) => (item) => item.paths ? { ...item, paths: cut(`${kind}.paths`, item.paths, SUMMARY_LISTS.finding_paths) } : item;
+  if (analysis.totals.files > 0) shortened.files = analysis.totals.files;
+  const excludedEntries = cut(
+    "excluded.entries",
+    analysis.excluded.entries,
+    SUMMARY_LISTS.excluded_entries,
+    analysis.excluded.omitted
+  );
+  return {
+    schema: analysis.schema,
+    schema_version: analysis.schema_version,
+    cli_version: analysis.cli_version,
+    view: "summary",
+    shortened,
+    mode: analysis.mode,
+    root: analysis.root,
+    ok: analysis.ok,
+    framework: analysis.framework,
+    project: analysis.project,
+    limits: analysis.limits,
+    totals: analysis.totals,
+    blockers: analysis.blockers.map(finding("blockers")),
+    // The note about the cap of the full file list describes a list that is not here.
+    warnings: analysis.warnings.filter((warning) => warning.code !== "file_list_truncated").map(finding("warnings")),
+    suggestions: analysis.suggestions.map(finding("suggestions")),
+    entry: {
+      ...analysis.entry,
+      candidates: cut("entry.candidates", analysis.entry.candidates, SUMMARY_LISTS.entry_candidates)
+    },
+    flattened_prefix: analysis.flattened_prefix,
+    largest_files: cut("largest_files", analysis.largest_files, SUMMARY_LISTS.largest_files),
+    by_class: analysis.by_class,
+    by_top_level: cut("by_top_level", analysis.by_top_level, SUMMARY_LISTS.by_top_level),
+    duplicates: cut("duplicates", analysis.duplicates, SUMMARY_LISTS.duplicates).map((group) => ({ ...group, paths: cut("duplicates.paths", group.paths, SUMMARY_LISTS.duplicate_paths) })),
+    embedded_media: cut("embedded_media", analysis.embedded_media, SUMMARY_LISTS.embedded_media),
+    excluded: {
+      ...analysis.excluded,
+      entries: excludedEntries,
+      omitted: analysis.excluded.omitted + analysis.excluded.entries.length - excludedEntries.length
+    },
+    dropped_by_platform: cut("dropped_by_platform", analysis.dropped_by_platform, SUMMARY_LISTS.dropped_by_platform),
+    files: [],
+    files_omitted: analysis.totals.files,
+    fingerprint: analysis.fingerprint
+  };
+}
+function summarizeAnalysis(analysis) {
+  let summary = summarize(analysis, 1);
+  for (let divisor = 2; divisor <= 32 && Buffer.byteLength(printAnalysis(summary), "utf8") > SUMMARY_MAX_BYTES; divisor *= 2) {
+    summary = summarize(analysis, divisor);
+  }
+  return summary;
+}
 function wouldUpload(analysis, force = false) {
   return analysis.blockers.every((blocker) => blocker.overridable && force);
 }
@@ -7425,6 +7502,13 @@ async function pushCommand(opts) {
       "--json belongs to --dry-run: `agentful push --dry-run --json` prints the upload analysis and uploads nothing."
     );
   }
+  if (opts.summary && !opts.json) {
+    throw new ApiError(
+      0,
+      "invalid_options",
+      "--summary belongs to --dry-run --json: it prints the analysis without the list of every file."
+    );
+  }
   if (!opts.json) console.log(banner());
   const mode = opts.prebuilt ? "dist" : "source";
   const cwd = process.cwd();
@@ -7438,8 +7522,7 @@ async function pushCommand(opts) {
     analysis = failedAnalysis(mode, cwd, { code: err2.code, message: err2.message });
   }
   if (opts.dryRun) {
-    if (opts.json) process.stdout.write(`${JSON.stringify(analysis, null, 2)}
-`);
+    if (opts.json) process.stdout.write(printAnalysis(opts.summary ? summarizeAnalysis(analysis) : analysis));
     else for (const line of renderAnalysis(analysis, { force: opts.force, dryRun: true })) console.log(line);
     if (!wouldUpload(analysis, opts.force)) process.exitCode = 1;
     return;
@@ -7968,75 +8051,6 @@ var agentful_theme_default = {
 
 // src/branding/commands.ts
 init_branding();
-var NEEDS_A_PUSH = 'If the command reports "No Agentful project here", nothing has been deployed from this directory yet \u2014 run `agentful push` first (it creates the project and a preview), then retry.';
-var SLASH_COMMANDS = {
-  setup: {
-    description: `${brand.displayName}: create or link the cloud project for this directory`,
-    template: 'Check whether .agentful/project.json exists. If it does, report the linked project title and id and stop. Otherwise run `agentful init --title "<name>"` using the bash tool, where <name> is $ARGUMENTS if I gave one, otherwise the current directory name. Report what it created and mention the title I can change it to. Do not modify any other project files.'
-  },
-  push: {
-    description: `${brand.displayName}: deploy this project and get a preview URL`,
-    template: "Run `agentful push` from the project root using the bash tool. It creates the project automatically if this directory is not linked yet. Stream what it prints, and when it finishes report the preview URL on its own line. If it fails: quote the printed error verbatim, and if the failure happened in the cloud (not in the pre-upload preflight), also run `agentful build-status` and quote its phase/error/details as the cause. Diagnose ONLY from those records \u2014 never invent causes, env vars, or settings they do not show. Do not modify project files unless I ask."
-  },
-  "build-status": {
-    description: `${brand.displayName}: show the last cloud build result`,
-    template: "Run `agentful build-status` from the project root using the bash tool and report what it prints: status, phase, framework, when it was recorded, and the error/details verbatim if it failed. That record is the only source of truth about the cloud build \u2014 do not speculate beyond it. " + NEEDS_A_PUSH
-  },
-  backend: {
-    description: `${brand.displayName}: open the Backend tab (managed DB + server actions)`,
-    template: "Run `agentful backend` from the project root using the bash tool and report the URL it opened. If it prints a declared backend (managed DB / server actions), summarize that and remind me that declared-in-code serves nothing until enabled in that tab. " + NEEDS_A_PUSH
-  },
-  preview: {
-    description: `${brand.displayName}: open the live preview in the browser`,
-    template: "Run `agentful open` from the project root using the bash tool and report the URL it opened. Note that `open` neither builds nor uploads. " + NEEDS_A_PUSH
-  },
-  publish: {
-    description: `${brand.displayName}: publish on a public subdomain`,
-    template: "Ask me for the subdomain if I did not provide one in $ARGUMENTS, then run `agentful publish <subdomain>` from the project root using the bash tool and report the public URL. " + NEEDS_A_PUSH
-  },
-  share: {
-    description: `${brand.displayName}: make the live preview public (or private again)`,
-    template: "Run `agentful share` from the project root using the bash tool (add `--private` if $ARGUMENTS says private) and report the resulting visibility and URL. " + NEEDS_A_PUSH
-  },
-  status: {
-    description: `${brand.displayName}: show the linked project and account`,
-    template: "Run `agentful whoami` using the bash tool. Then read .agentful/project.json and report the linked project title and id, plus the preview URL https://preview-<projectId>.agentful.page/. If the file does not exist, say that this directory is not linked yet and that `/setup` creates the link."
-  }
-};
-function commandMarkdown(name) {
-  const cmd = SLASH_COMMANDS[name];
-  const description = JSON.stringify(cmd.description);
-  return `---
-description: ${description}
-agent: ${cmd.agent ?? "agentful-build"}
----
-
-${cmd.template}
-`;
-}
-
-// src/lib/tools.ts
-var import_node_fs13 = require("fs");
-var import_node_path15 = require("path");
-function assetsDir() {
-  const here = (0, import_node_path15.dirname)(process.argv[1] || "");
-  for (const candidate of [(0, import_node_path15.join)(here, "..", "assets"), (0, import_node_path15.join)(here, "assets")]) {
-    if ((0, import_node_fs13.existsSync)((0, import_node_path15.join)(candidate, "tools", "imagegen.ts"))) return candidate;
-  }
-  return null;
-}
-function installEngineTools(configDir2) {
-  const assets = assetsDir();
-  if (!assets) return false;
-  const target = (0, import_node_path15.join)(configDir2, "tools");
-  (0, import_node_fs13.mkdirSync)(target, { recursive: true });
-  try {
-    (0, import_node_fs13.cpSync)((0, import_node_path15.join)(assets, "tools"), target, { recursive: true });
-    return true;
-  } catch {
-    return false;
-  }
-}
 
 // src/lib/cloudTarget.ts
 var CLOUD_INSTRUCTIONS_FILENAME = "AGENTFUL_CLOUD.md";
@@ -8146,6 +8160,87 @@ function serverSideSection() {
     )
   ].join("\n\n");
 }
+var PUSH_ANALYSIS_COMMAND = "agentful push --dry-run --json --summary";
+function pushSection() {
+  const excludedDirs = [...ALWAYS_EXCLUDE_DIRS].filter((name) => /^[a-z]/.test(name)).map((name) => `\`${name}\``).join(", ");
+  return `## Pushing to the platform (\`agentful push\`)
+
+Two ways to upload. Every push replaces the previous upload completely, so a
+site can never be uploaded in several parts.
+
+- **Source push**, \`agentful push\`: uploads this directory, then builds it in
+  the cloud. Never uploaded: paths listed in \`.gitignore\`, \`.env*\` files,
+  symlinks, tool folders such as \`.git\` or \`.next\`, and any folder named
+  ${excludedDirs}, at any depth.
+  The cloud build runs \`npm ci\` (with a \`package-lock.json\`, otherwise
+  \`npm install\`) and then the build command from the table above. Nothing
+  else runs: no other package manager, no separate data or prepare script, no
+  CI workflow step.
+- **Prebuilt push**, \`agentful push --prebuilt --dir <folder>\`: uploads a
+  finished output folder and serves it as it is. No cloud build, \`.gitignore\`
+  is not applied, and \`index.html\` must sit at the top of that folder. It
+  carries the website only: the project source in the cloud stays as it was (a
+  later build in the cloud workspace replaces the site with a build of that
+  source), and Managed Server Actions and \`.agentful/backend.json\` are NOT
+  deployed by it.
+
+Limits of one push, either way: about ${formatBytes(maxZipBytesForUpload(), "down")} compressed, ${formatBytes(MAX_UNPACKED_BYTES)} of files, ${MAX_UPLOAD_FILES.toLocaleString("en-US")} files.
+\`--force\` lifts none of them: it only lets the cloud build try despite a
+compatibility finding.
+
+**The analysis decides, not an estimate.** \`${PUSH_ANALYSIS_COMMAND}\`
+(with \`--prebuilt --dir <folder>\` for a prebuilt push) reads the files and
+reports what a push would upload: no sign-in, no project, no upload, nothing
+written. Sizes, limits, what is left out and what blocks the upload come from
+that report and from nowhere else: quote its figures, never estimate or
+recompute them (\`limits.max_zip_bytes\` is the exact limit for this push).
+Run it before the first push of a session, after a push was stopped, and after
+you changed what gets uploaded. In between, \`agentful push\` applies the same
+check itself and stops before sign-in when something blocks. A blocker with
+\`"overridable": false\` is final, the platform rejects that upload: do not
+retry, do not add \`--force\`, do not look for another route.
+
+Every change to the user's files for a push (including \`.gitignore\`) and every
+project script you run for it needs the user's OK first: name the concrete
+change, ask, wait for the answer.
+
+- **No start page** (\`entry_missing\`): the platform serves \`index.html\` from
+  the top level. With \`entry.candidates\`: show them (path and title;
+  \`same_content_as\` marks copies) and ask which page opens first. A candidate
+  at the top level can be renamed to \`index.html\`, or copied, which keeps the
+  old address and adds the file's size to the upload: ask which. A candidate
+  in a subfolder must not be copied up, its relative links would break. If
+  that folder is the whole site, push the folder (\`suggestions\` carries the
+  command); otherwise adjust the links and show the diff. Without candidates,
+  ask which folder holds the site.
+- **Too large or too many files** (\`zip_too_large\`, \`unpacked_too_large\`,
+  \`too_many_files\`): explain where the size is, from \`largest_files\`,
+  \`by_top_level\`, \`duplicates\` and \`embedded_media\` (media stored inside text
+  files as \`data:\` URLs). The ways out that exist: leave out files the site
+  does not load (\`.gitignore\`, source push), or push only the finished output
+  folder (prebuilt). Before proposing to leave a file out, search the sources
+  for references to it and say what you checked: identical content does not
+  make a copy unused. Never shrink, re-encode, move or delete the user's files
+  on your own. If what the site needs stays above the limits, say plainly that
+  it cannot be pushed yet. Larger uploads are not available.
+- **Compatibility findings** (\`"overridable": true\`): fix the cause in the
+  code. \`--force\` only when the user asks to try the cloud build anyway.
+- **Files that would be missing on the site:** the warnings
+  \`dropped_by_platform\` and \`excluded_static_directory\`, and entries of
+  \`excluded.entries\` with reason \`gitignore\` that the site loads at runtime
+  (generated data under \`public/\`, for example). The build can succeed and the
+  site still be broken: tell the user before pushing and ask.
+- **Steps the cloud build does not run:** before the first push of a project
+  you did not create in this session, read the \`package.json\` scripts, the
+  README and the CI workflows for data generation, code generation or another
+  package manager. If the site needs such a step, a source push is the wrong
+  way: build locally with the project's own commands and its real data, keep
+  its checks, and push the output folder prebuilt. Never put sample data in
+  place of real data to get a push through.
+
+A finished build or upload does not prove that the site works: say what you
+verified and what you did not.`;
+}
 function renderCloudInstructions(framework, backend) {
   return `# Agentful Cloud target (platform contract)
 
@@ -8300,6 +8395,8 @@ user's conscious step \u2014 in that tab, or by answering the question
 \`agentful push\` asks once (it names both consequences; a non-interactive
 push never enables anything).
 
+${pushSection()}
+
 ## Diagnosing failed pushes and cloud builds (hard rule)
 
 Diagnose **only from evidence**: the preflight output of \`agentful push\`, and
@@ -8318,6 +8415,93 @@ ${backendSessionLines(backend)}
 `;
 }
 
+// src/branding/commands.ts
+var PUSH_TOOL_TIMEOUT_MS = 9e5;
+var NEEDS_A_PUSH = 'If the command reports "No Agentful project here", nothing has been deployed from this directory yet \u2014 run `agentful push` first (it creates the project and a preview), then retry.';
+var SLASH_COMMANDS = {
+  setup: {
+    description: `${brand.displayName}: create or link the cloud project for this directory`,
+    template: 'Check whether .agentful/project.json exists. If it does, report the linked project title and id and stop. Otherwise run `agentful init --title "<name>"` using the bash tool, where <name> is $ARGUMENTS if I gave one, otherwise the current directory name. Report what it created and mention the title I can change it to. Do not modify any other project files.'
+  },
+  // The analysis comes first (upload plan AP7): the report, not the model,
+  // says what would be uploaded, how large it is and what blocks it, and the
+  // rules for acting on it are in AGENTFUL_CLOUD.md. Two things the agent's
+  // shell tool forces on this template: `--summary`, because the tool cuts
+  // output after 2,000 lines or 50 KB and the full report lists every file;
+  // and an explicit timeout, because the tool ends a command after two
+  // minutes by default and a cloud build takes longer (engine 1.18.32).
+  push: {
+    description: `${brand.displayName}: check, deploy and get a preview URL`,
+    template: `Deploy this project, following "Pushing to the platform" in AGENTFUL_CLOUD.md. Run every command from the project root using the bash tool. What I typed after the command (may be empty): "$ARGUMENTS". If it names \`--prebuilt\`, a folder for \`--dir\`, or \`--force\`, pass that on to both commands below.
+
+1. Run \`${PUSH_ANALYSIS_COMMAND}\`. It only reads files: no sign-in, no upload. Its JSON report is the only source for sizes, limits and what blocks the upload: quote its figures, never estimate them.
+2. If the report or the project calls for a decision (a blocker, a file the site needs that would not be uploaded, a build step the cloud does not run), explain the finding in plain words with the figures of the report and ask me how to proceed. One question at a time, then wait for my answer. Until then do not change any file, do not run project scripts and do not push.
+3. After a change I approved, run the analysis again.
+4. When nothing blocks, run \`agentful push\` with the bash tool's \`timeout\` set to ${PUSH_TOOL_TIMEOUT_MS} (milliseconds): the cloud build takes minutes and the default timeout would cut the push off halfway. The command never waits for input. It creates the project automatically if this directory is not linked yet.
+5. Report the preview URL on its own line and what the push printed about the backend. If it fails: quote the printed error verbatim, and if the failure happened in the cloud (not before the upload), also run \`agentful build-status\` and quote its phase/error/details as the cause. Diagnose ONLY from those records \u2014 never invent causes, env vars, or settings they do not show.
+
+Apart from a change I approved in step 2, do not modify project files.`
+  },
+  "build-status": {
+    description: `${brand.displayName}: show the last cloud build result`,
+    template: "Run `agentful build-status` from the project root using the bash tool and report what it prints: status, phase, framework, when it was recorded, and the error/details verbatim if it failed. That record is the only source of truth about the cloud build \u2014 do not speculate beyond it. " + NEEDS_A_PUSH
+  },
+  backend: {
+    description: `${brand.displayName}: open the Backend tab (managed DB + server actions)`,
+    template: "Run `agentful backend` from the project root using the bash tool and report the URL it opened. If it prints a declared backend (managed DB / server actions), summarize that and remind me that declared-in-code serves nothing until enabled in that tab. " + NEEDS_A_PUSH
+  },
+  preview: {
+    description: `${brand.displayName}: open the live preview in the browser`,
+    template: "Run `agentful open` from the project root using the bash tool and report the URL it opened. Note that `open` neither builds nor uploads. " + NEEDS_A_PUSH
+  },
+  publish: {
+    description: `${brand.displayName}: publish on a public subdomain`,
+    template: "Ask me for the subdomain if I did not provide one in $ARGUMENTS, then run `agentful publish <subdomain>` from the project root using the bash tool and report the public URL. " + NEEDS_A_PUSH
+  },
+  share: {
+    description: `${brand.displayName}: make the live preview public (or private again)`,
+    template: "Run `agentful share` from the project root using the bash tool (add `--private` if $ARGUMENTS says private) and report the resulting visibility and URL. " + NEEDS_A_PUSH
+  },
+  status: {
+    description: `${brand.displayName}: show the linked project and account`,
+    template: "Run `agentful whoami` using the bash tool. Then read .agentful/project.json and report the linked project title and id, plus the preview URL https://preview-<projectId>.agentful.page/. If the file does not exist, say that this directory is not linked yet and that `/setup` creates the link."
+  }
+};
+function commandMarkdown(name) {
+  const cmd = SLASH_COMMANDS[name];
+  const description = JSON.stringify(cmd.description);
+  return `---
+description: ${description}
+agent: ${cmd.agent ?? "agentful-build"}
+---
+
+${cmd.template}
+`;
+}
+
+// src/lib/tools.ts
+var import_node_fs13 = require("fs");
+var import_node_path15 = require("path");
+function assetsDir() {
+  const here = (0, import_node_path15.dirname)(process.argv[1] || "");
+  for (const candidate of [(0, import_node_path15.join)(here, "..", "assets"), (0, import_node_path15.join)(here, "assets")]) {
+    if ((0, import_node_fs13.existsSync)((0, import_node_path15.join)(candidate, "tools", "imagegen.ts"))) return candidate;
+  }
+  return null;
+}
+function installEngineTools(configDir2) {
+  const assets = assetsDir();
+  if (!assets) return false;
+  const target = (0, import_node_path15.join)(configDir2, "tools");
+  (0, import_node_fs13.mkdirSync)(target, { recursive: true });
+  try {
+    (0, import_node_fs13.cpSync)((0, import_node_path15.join)(assets, "tools"), target, { recursive: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/lib/engineConfig.ts
 var PROVIDER_ID = "agentful";
 var DISABLED_ENGINE_PLUGINS = {
@@ -8555,18 +8739,20 @@ var SCAFFOLD_BY_FRAMEWORK = {
   // cra/nuxt get no scaffold skill: the react/vue skills are Vite-specific
   // and would teach the wrong shape — the template contract still applies.
 };
-function hasVueDependency(rootDir) {
+function dependencies(rootDir) {
   try {
     const pkg = JSON.parse((0, import_node_fs15.readFileSync)((0, import_node_path17.join)(rootDir, "package.json"), "utf8"));
-    return Boolean({ ...pkg.dependencies, ...pkg.devDependencies }["vue"]);
+    return { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
-    return false;
+    return {};
   }
 }
 function selectSkills(framework, rootDir) {
   const names = [CONTRACT_SKILL];
   if (framework === "vite") {
-    names.push(hasVueDependency(rootDir) ? "vue-scaffold" : "react-scaffold");
+    const deps = dependencies(rootDir);
+    if (deps.vue) names.push("vue-scaffold");
+    else if (deps.react) names.push("react-scaffold");
   } else {
     const scaffold = SCAFFOLD_BY_FRAMEWORK[framework];
     if (scaffold) names.push(scaffold);
@@ -9895,7 +10081,7 @@ program2.command("login").description("Sign in to your Agentful account (device
 program2.command("logout").description("Remove the stored credentials").action(run(logoutCommand));
 program2.command("whoami").description("Show the signed-in account").action(run(whoamiCommand));
 program2.command("init").description("Create (or link) the Agentful cloud project for this directory").argument("[directory]", "with --template: new folder to scaffold into (created for you)").option("--link <projectId>", "link an existing project instead of creating one").option("--title <title>", "project title (skips the prompt)").option("--template <framework>", "scaffold from a platform starter (nextjs, react, vue, vanilla)").action(run((directory, opts) => initCommand(opts, directory)));
-program2.command("push").description("Upload this project and get a live preview URL").option("--prebuilt", "upload a locally built output instead of building in the cloud").option("--dir <path>", "built-output directory for --prebuilt (default: auto-detect)").option("--force", "push even when the pre-upload compatibility check finds blocking issues").option("-y, --yes", "enable the declared managed database without asking (CI); a non-interactive push never enables it").option("--dry-run", "analyse only: what would be uploaded, how large, and what would block it \u2014 no sign-in, no project, no upload").option("--json", "with --dry-run: print the analysis as JSON (for scripts and agents)").action(run((opts) => pushCommand(opts)));
+program2.command("push").description("Upload this project and get a live preview URL").option("--prebuilt", "upload a locally built output instead of building in the cloud").option("--dir <path>", "built-output directory for --prebuilt (default: auto-detect)").option("--force", "push even when the pre-upload compatibility check finds blocking issues").option("-y, --yes", "enable the declared managed database without asking (CI); a non-interactive push never enables it").option("--dry-run", "analyse only: what would be uploaded, how large, and what would block it \u2014 no sign-in, no project, no upload").option("--json", "with --dry-run: print the analysis as JSON (for scripts and agents)").option("--summary", "with --dry-run --json: totals and findings without the list of every file").action(run((opts) => pushCommand(opts)));
 program2.command("build-status").description("Show the cloud's record of the last build (the real error on failures)").action(run(buildStatusCommand));
 program2.command("backend").description("Open this project's Backend tab (managed DB + server actions) in the browser").action(run(backendCommand));
 program2.command("open").description("Open the live preview in the browser").action(run(openCommand));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentful",
-  "version": "0.4.14",
+  "version": "0.4.15",
   "description": "Agentful in your terminal — local development with push-to-cloud previews",
   "license": "Apache-2.0",
   "homepage": "https://agentful.dev",