@base44-preview/cli 0.1.15-pr.631.fed67f3 → 0.1.15-pr.632.1a53729

package/README.md

@@ -67,7 +67,7 @@ The CLI will guide you through project setup. For step-by-step tutorials, see th
 | [`sandbox edit`](https://docs.base44.com/developers/references/cli/commands/sandbox-edit) | Apply exact old→new string edits to a file in the sandbox |
 | [`sandbox grep`](https://docs.base44.com/developers/references/cli/commands/sandbox-grep) | Search files for a pattern in an app's remote sandbox |
 | [`sandbox run`](https://docs.base44.com/developers/references/cli/commands/sandbox-run) | Run a shell command in an app's remote sandbox |
-| [`sandbox checkpoint`](https://docs.base44.com/developers/references/cli/commands/sandbox-checkpoint) | Create a restore-point checkpoint of an app's remote sandbox |
+| [`sandbox checkpoint`](https://docs.base44.com/developers/references/cli/commands/sandbox-checkpoint) | Save a restore point in the builder's version history; run it after each unit of work, since sandbox writes are committed but not checkpointed and a Restore or Revert in the builder discards everything after the last checkpoint |
 | [`site deploy`](https://docs.base44.com/developers/references/cli/commands/site-deploy) | Deploy built site files to Base44 hosting |
 | [`site open`](https://docs.base44.com/developers/references/cli/commands/site-open) | Open the published site in your browser |
 | [`types generate`](https://docs.base44.com/developers/references/cli/commands/types-generate) | Generate TypeScript types from project resources |

package/dist/cli/index.js

@@ -250665,6 +250665,11 @@ function createCheckpoint(appId, params) {
 }
 
 // src/cli/commands/sandbox/shared.ts
+var CHECKPOINT_HELP = `
+Writes are committed but not checkpointed. Only checkpoints appear in the
+builder's version history, and a Restore or Revert there rolls the app back to
+the last checkpoint and discards everything written after it. Run
+\`base44 sandbox checkpoint\` when you finish a unit of work and before you stop.`;
 async function resolveFlagOrStdin(flagValue, flagName) {
   if (flagValue !== undefined) {
     return flagValue;
@@ -250695,7 +250700,14 @@ async function checkpointAction({ runTask, branchId }, options) {
   return { outroMessage: "Created checkpoint", stdout: toJsonStdout(result) };
 }
 function getSandboxCheckpointCommand() {
-  return new Base44Command("checkpoint", { supportsBranch: true }).description("Create a restore-point checkpoint of an app's remote sandbox").option("--name <name>", "Optional message/title for the checkpoint (defaults to an auto-generated title)").addHelpText("after", `
+  return new Base44Command("checkpoint", { supportsBranch: true }).description("Save a restore point in the builder's version history (run after each unit of work)").option("--name <name>", "Optional title, ideally a short summary of what changed (defaults to an auto-generated title)").addHelpText("after", `
+Sandbox writes are committed but not checkpointed. Only checkpoints appear in
+the builder's version history, and a Restore or Revert there rolls the app back
+to the last checkpoint and discards everything written after it. Run this when
+you finish a unit of work and always before you stop, so the user can restore
+your work instead of losing it. Pending changes are flushed first, so the
+checkpoint captures your latest code.
+
 Examples:
   $ base44 sandbox checkpoint
   $ base44 sandbox checkpoint --name "before refactor"`).action(checkpointAction);
@@ -250738,6 +250750,7 @@ async function editFileAction({ runTask, branchId }, path, options) {
 function getSandboxEditFileCommand() {
   return new Base44Command("edit", { supportsBranch: true }).description("Apply exact old→new string edits to a file in the sandbox").argument("<path>", "File path relative to the app root").option("--edits-json <json>", "JSON array of edits (if omitted, read from stdin)").option("--dry-run", "Return the unified diff without writing").addHelpText("after", `
 Each edit is { "old_text": "...", "new_text": "...", "replace_all"?: true }.
+${CHECKPOINT_HELP}
 
 Examples:
   $ echo '[{"old_text":"foo","new_text":"bar"}]' | base44 sandbox edit src/x.ts
@@ -250807,6 +250820,8 @@ async function runCommandAction({ runTask, branchId }, commandParts, options) {
 }
 function getSandboxRunCommandCommand() {
   return new Base44Command("run", { supportsBranch: true }).description("Run a shell command in an app's remote sandbox").argument("<command...>", "Shell command to execute (quote to keep as one)").option("--cwd <path>", "Working directory relative to the app root").option("--timeout-ms <n>", "Timeout in milliseconds (default 120000, max 600000)").addHelpText("after", `
+A command that changes files needs a checkpoint too.${CHECKPOINT_HELP}
+
 Examples:
   $ base44 sandbox run "npm test"
   $ base44 sandbox run ls -la --cwd src`).action(runCommandAction);
@@ -250825,7 +250840,8 @@ async function writeFileAction({ runTask, branchId }, path, options) {
   return { outroMessage: "Wrote file", stdout: toJsonStdout(result) };
 }
 function getSandboxWriteFileCommand() {
-  return new Base44Command("write", { supportsBranch: true }).description("Create or overwrite a file in an app's remote sandbox").argument("<path>", "File path relative to the app root").option("--content <content>", "File content (if omitted, read from stdin)").option("--overwrite", "Overwrite the file if it already exists").addHelpText("after", `
+  return new Base44Command("write", { supportsBranch: true }).description("Create or overwrite a file in an app's remote sandbox").argument("<path>", "File path relative to the app root").option("--content <content>", "File content (if omitted, read from stdin)").option("--overwrite", "Overwrite the file if it already exists").addHelpText("after", `${CHECKPOINT_HELP}
+
 Examples:
   $ echo "hello" | base44 sandbox write notes.txt
   $ base44 sandbox write notes.txt --content "hello" --overwrite`).action(writeFileAction);
@@ -250833,7 +250849,7 @@ Examples:
 
 // src/cli/commands/sandbox/index.ts
 function getSandboxCommand() {
-  return new Command2("sandbox").description("Develop an app remotely via its server-side sandbox").addCommand(getSandboxListDirectoryCommand()).addCommand(getSandboxReadFileCommand()).addCommand(getSandboxWriteFileCommand()).addCommand(getSandboxEditFileCommand()).addCommand(getSandboxGrepCommand()).addCommand(getSandboxRunCommandCommand()).addCommand(getSandboxCheckpointCommand());
+  return new Command2("sandbox").description("Develop an app remotely via its server-side sandbox").addHelpText("after", CHECKPOINT_HELP).addCommand(getSandboxListDirectoryCommand()).addCommand(getSandboxReadFileCommand()).addCommand(getSandboxWriteFileCommand()).addCommand(getSandboxEditFileCommand()).addCommand(getSandboxGrepCommand()).addCommand(getSandboxRunCommandCommand()).addCommand(getSandboxCheckpointCommand());
 }
 
 // src/cli/commands/secrets/delete.ts
@@ -259913,4 +259929,4 @@ export {
   runCLI
 };
 
-//# debugId=EF36A7D77029953264756E2164756E21
+//# debugId=3CF1426A84AA996C64756E2164756E21