agentful 0.2.0 → 0.2.1

package/dist/index.cjs

@@ -3044,7 +3044,7 @@ var VERSION, brand, useColor, wrap, paint, sym, ui;
 var init_branding = __esm({
   "src/branding.ts"() {
     "use strict";
-    VERSION = "0.2.0" ? "0.2.0" : null.version;
+    VERSION = "0.2.1" ? "0.2.1" : null.version;
     brand = {
       name: "agentful",
       // the command users type
@@ -4395,7 +4395,8 @@ function materializeStarter(name, targetDir, projectName) {
     throw new ApiError(
       0,
       "directory_not_empty",
-      `This directory is not empty (found ${blockers.slice(0, 3).join(", ")}${blockers.length > 3 ? ", \u2026" : ""}). \`init --template\` scaffolds into an empty directory only \u2014 it never overwrites your files.`
+      `This directory is not empty (found ${blockers.slice(0, 3).join(", ")}${blockers.length > 3 ? ", \u2026" : ""}). \`init --template\` scaffolds into an empty directory only \u2014 it never overwrites your files.
+Pass a new folder name instead: \`agentful init --template ${name} my-app\` (creates it for you).`
     );
   }
   let written = 0;
@@ -4419,16 +4420,15 @@ function materializeStarter(name, targetDir, projectName) {
 function slugify(value) {
   return value.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
 }
+function prepareScaffoldDirectory(baseDir, directory) {
+  const target = (0, import_node_path4.resolve)(baseDir, directory);
+  (0, import_node_fs3.mkdirSync)(target, { recursive: true });
+  return target;
+}
 
 // src/commands/init.ts
-async function initCommand(opts) {
+async function initCommand(opts, directory) {
   console.log(banner());
-  const existing = readProjectConfig();
-  if (existing) {
-    ui.info(`Already initialized (project ${existing.projectId} \u2014 "${existing.title}").`);
-    ui.info("Delete .agentful/project.json to re-initialize.");
-    return;
-  }
   if (opts.template && opts.link) {
     throw new ApiError(
       0,
@@ -4436,6 +4436,22 @@ async function initCommand(opts) {
       "--template scaffolds a new project and cannot be combined with --link."
     );
   }
+  if (directory && !opts.template) {
+    throw new ApiError(
+      0,
+      "invalid_options",
+      "A target directory only makes sense with --template \u2014 plain `init` links the directory you are in."
+    );
+  }
+  if (opts.template && directory) {
+    process.chdir(prepareScaffoldDirectory(process.cwd(), directory));
+  }
+  const existing = readProjectConfig();
+  if (existing) {
+    ui.info(`Already initialized (project ${existing.projectId} \u2014 "${existing.title}").`);
+    ui.info("Delete .agentful/project.json to re-initialize.");
+    return;
+  }
   if (opts.template) {
     const title2 = opts.title?.trim() || (0, import_node_path5.basename)(process.cwd());
     ui.step(`Scaffolding from the ${opts.template} starter\u2026`);
@@ -4465,6 +4481,7 @@ async function initCommand(opts) {
   const config = await createProject(auth, title);
   ui.ok(`Project created (${config.projectId}). Next: \`agentful push\``);
   if (opts.template) {
+    if (directory) ui.info(`Next: \`cd ${directory}\` \u2014 the project lives there now.`);
     ui.info("Run `npm install` before local dev; `agentful push` builds in the cloud either way.");
     ui.info(`Or start the coding agent right away: \`agentful\` (templates: ${STARTER_NAMES.join(", ")}).`);
   }
@@ -5404,9 +5421,9 @@ var contract_default = {
       details: "raw build output excerpt"
     },
     adopted_by: {
-      build_engine: ["status", "timestamp", "error", "details", "framework"],
-      executor: ["status", "timestamp", "phase", "error"],
-      $comment: "Current state, not the target: the engine writes no phase codes and neither builder writes build_id/started_at/status:running yet. Full adoption is AP4 (engine) + AP5 (executor); until then the CLI must not poll against build identity \u2014 it uses the timestamp freshness guard instead."
+      build_engine: ["schema_version", "build_id", "started_at", "status", "timestamp", "phase", "error", "details", "framework"],
+      executor: ["schema_version", "build_id", "started_at", "status", "timestamp", "phase", "error"],
+      $comment: "Both builders write the attempt identity since AP4/AP5 (2026-08-18); failures carry phase codes and \u2014 for contract violations \u2014 code/reason/hints. The engine additionally writes a running record at start; the executor has no separate build-start moment (started_at is the turn start) and writes no running record. The CLI may graduate from timestamp freshness to identity-based polling for the ENGINE path."
     }
   }
 };
@@ -6688,7 +6705,7 @@ async function tuiCommand(opts = {}) {
   }
   console.log("");
   if (process.stdout.isTTY) process.stdout.write(`\x1B]0;${brand.displayName}\x07`);
-  const code = await new Promise((resolve) => {
+  const code = await new Promise((resolve2) => {
     const engineArgs = opts.session ? ["--session", opts.session] : [];
     const child = (0, import_node_child_process5.spawn)(binPath, engineArgs, {
       stdio: "inherit",
@@ -6715,10 +6732,10 @@ async function tuiCommand(opts = {}) {
         ...session.image_model ? { IMAGE_MODEL: session.image_model } : {}
       }
     });
-    child.on("exit", (c) => resolve(c ?? 0));
+    child.on("exit", (c) => resolve2(c ?? 0));
     child.on("error", (err2) => {
       ui.fail(`Could not start the engine: ${err2.message}`);
-      resolve(1);
+      resolve2(1);
     });
   });
   try {
@@ -6992,7 +7009,7 @@ program2.name("agentful").description("Agentful in your terminal \u2014 local de
 program2.command("login").description("Sign in to your Agentful account (device flow)").option("--no-browser", "do not open the browser automatically").action(run((opts) => loginCommand({ browser: opts.browser !== false })));
 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").option("--link <projectId>", "link an existing project instead of creating one").option("--title <title>", "project title (skips the prompt)").option("--template <framework>", "scaffold this empty directory from a platform starter (nextjs, react, vue, vanilla)").action(run((opts) => initCommand(opts)));
+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").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("open").description("Open the live preview in the browser").action(run(openCommand));

package/package.json

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