better-commits 1.20.0-cli-flags → 1.20.0

package/.svelte-kit/generated/client/app.js

@@ -1,28 +0,0 @@
-export { matchers } from './matchers.js';
-
-export const nodes = [
-	() => import('./nodes/0'),
-	() => import('./nodes/1')
-];
-
-export const server_loads = [];
-
-export const dictionary = {
-		
-	};
-
-export const hooks = {
-	handleError: (({ error }) => { console.error(error) }),
-	
-	reroute: (() => {}),
-	transport: {}
-};
-
-export const decoders = Object.fromEntries(Object.entries(hooks.transport).map(([k, v]) => [k, v.decode]));
-export const encoders = Object.fromEntries(Object.entries(hooks.transport).map(([k, v]) => [k, v.encode]));
-
-export const hash = false;
-
-export const decode = (type, value) => decoders[type](value);
-
-export { default as root } from '../root.js';

package/.svelte-kit/generated/client/matchers.js

@@ -1 +0,0 @@
-export const matchers = {};

package/.svelte-kit/generated/client/nodes/0.js

@@ -1 +0,0 @@
-export { default as component } from "../../../../../node_modules/@sveltejs/kit/src/runtime/components/svelte-5/layout.svelte";

package/.svelte-kit/generated/client/nodes/1.js

@@ -1 +0,0 @@
-export { default as component } from "../../../../../node_modules/@sveltejs/kit/src/runtime/components/svelte-5/error.svelte";

package/.svelte-kit/tsconfig.json

@@ -1,49 +0,0 @@
-{
-	"compilerOptions": {
-		"paths": {
-			"$app/types": [
-				"./types/index.d.ts"
-			]
-		},
-		"rootDirs": [
-			"..",
-			"./types"
-		],
-		"verbatimModuleSyntax": true,
-		"isolatedModules": true,
-		"lib": [
-			"esnext",
-			"DOM",
-			"DOM.Iterable"
-		],
-		"moduleResolution": "bundler",
-		"module": "esnext",
-		"noEmit": true,
-		"target": "esnext"
-	},
-	"include": [
-		"ambient.d.ts",
-		"non-ambient.d.ts",
-		"./types/**/$types.d.ts",
-		"../vite.config.js",
-		"../vite.config.ts",
-		"../src/**/*.js",
-		"../src/**/*.ts",
-		"../src/**/*.svelte",
-		"../test/**/*.js",
-		"../test/**/*.ts",
-		"../test/**/*.svelte",
-		"../tests/**/*.js",
-		"../tests/**/*.ts",
-		"../tests/**/*.svelte"
-	],
-	"exclude": [
-		"../node_modules/**",
-		"../src/service-worker.js",
-		"../src/service-worker/**/*.js",
-		"../src/service-worker.ts",
-		"../src/service-worker/**/*.ts",
-		"../src/service-worker.d.ts",
-		"../src/service-worker/**/*.d.ts"
-	]
-}

package/0001-feat-branch-124-update-worktrees-feature.patch

@@ -1,316 +0,0 @@
-From 8f6f28a9e249988ac00350defdb852c0bcdea615 Mon Sep 17 00:00:00 2001
-From: everduin94 <everduin94@gmail.com>
-Date: Thu, 4 Sep 2025 08:53:43 -0500
-Subject: [PATCH] feat(branch): #124 update worktrees feature
-
-DEPRECATED: replaced enable_worktrees in favor of worktrees.enable
-
-Closes: #124
----
- .better-commits.json |  6 +---
- readme.md            | 85 +++++++++++++++++++++-----------------------
- src/branch.ts        | 37 +++++++++----------
- src/utils.ts         | 26 --------------
- src/valibot-state.ts | 15 ++++----
- 5 files changed, 68 insertions(+), 101 deletions(-)
-
-diff --git a/.better-commits.json b/.better-commits.json
-index a2a964b..3dce2fc 100644
---- a/.better-commits.json
-+++ b/.better-commits.json
-@@ -41,9 +41,5 @@
-     "git checkout main",
-     "git pull -r origin main",
-     "npm install"
--  ],
--  "worktree_config": {
--    "base_path": "../",
--    "folder_template": "{{repo_name}}-{{user}}-{{type}}-{{branch_description}}"
--  }
-+  ]
- }
-diff --git a/readme.md b/readme.md
-index 7376317..cf46fb1 100644
---- a/readme.md
-+++ b/readme.md
-@@ -42,16 +42,15 @@ npm install -g better-commits
- 
- ## 🚀 Usage
- 
--When you're ready to commit. To run the CLI in your terminal:
-+To run the CLI in your terminal:
- 
- ```sh
--better-commits
--# or
--npx better-commits
-+better-commits # Create a new commit
-+better-branch # Create a new branch
- ```
- 
--It will prompt a series of questions. These prompts will build a commit message, which you can preview, before confirming the commit.
--Some of the values in these prompts will be infered by your branch name and auto populated. You can adjust this in your `.better-commits.json` configuration file.
-+`better-commits` will prompt a series of questions. These prompts will build a commit message, which you can preview, before confirming the commit.
-+Some of the values in these prompts will be inferred by your branch name and auto populated. You can adjust this in your `.better-commits.json` configuration file.
- 
- To better understand these prompts and their intention, read [Conventional Commits Summary](https://www.conventionalcommits.org/en/v1.0.0-beta.4/#summary)
- 
-@@ -251,10 +250,10 @@ Better-commits (& better-branch) are highly flexible with sane defaults. These o
-   },
-   "branch_action_default": "branch",
-   "branch_order": ["user", "version", "type", "ticket", "description"],
--  "enable_worktrees": true,
--  "worktree_config": {
--    "base_path": "../",
--    "folder_template": "{{repo_name}}-{{branch_description}}"
-+  "worktrees": {
-+    "enable": true,
-+    "base_path": "..",
-+    "folder_template": "{{repo_name}}-{{ticket}}-{{branch_description}}"
-   },
-   "overrides": {
-     "shell": "/bin/sh"
-@@ -327,30 +326,31 @@ Expand to see explanations and possible values
- 
- Branch configuration (same config file, split for readability)
- 
--| Property                        | Description                                               |
--| ------------------------------- | --------------------------------------------------------- |
--| `branch_pre_commands`           | Array of shell commands to run before branching           |
--| `branch_post_commands`          | Array of shell commands to run after branching            |
--| `worktree_pre_commands`         | Array of shell commands to run before creating worktree   |
--| `worktree_post_commands`        | Array of shell commands to run after creating worktree    |
--| `branch_user.enable`            | If enabled include user name                              |
--| `branch_user.required`          | If enabled require user name                              |
--| `branch_user.separator`         | Branch delimeter - "/" (default), "-", "\_"               |
--| `branch_type.enable`            | If enabled include type                                   |
--| `branch_type.separator`         | Branch delimeter - "/" (default), "-", "\_"               |
--| `branch_ticket.enable`          | If enabled include ticket                                 |
--| `branch_ticket.required`        | If enabled require ticket                                 |
--| `branch_ticket.separator`       | Branch delimeter - "/", "-" (default), "\_"               |
--| `branch_description.max_length` | Max length branch name                                    |
--| `branch_description.separator`  | Branch delimeter - "" (default), "/", "-", "\_"           |
--| `branch_version.enable`         | If enabled include version                                |
--| `branch_version.required`       | If enabled require version                                |
--| `branch_version.separator`      | Branch delimeter - "", "/" (default), "-", "\_"           |
--| `branch_order`                  | Order of branch name values (doesn't effect prompt order) |
--| `branch_action_default`         | "branch" or "worktree"                                    |
--| `enable_worktrees`              | If false, always default to branch action                 |
--| `worktree_config.base_path`     | Directory where worktrees are created (default: "../")    |
--| `worktree_config.folder_template` | Template for worktree folder names with variables like {{repo_name}}, {{branch_description}}, {{user}}, {{type}}, {{ticket}}, {{version}} |
-+| Property                        | Description                                                                                                                               |
-+| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-+| `branch_pre_commands`           | Array of shell commands to run before branching                                                                                           |
-+| `branch_post_commands`          | Array of shell commands to run after branching                                                                                            |
-+| `worktree_pre_commands`         | Array of shell commands to run before creating worktree                                                                                   |
-+| `worktree_post_commands`        | Array of shell commands to run after creating worktree                                                                                    |
-+| `branch_user.enable`            | If enabled include user name                                                                                                              |
-+| `branch_user.required`          | If enabled require user name                                                                                                              |
-+| `branch_user.separator`         | Branch delimeter - "/" (default), "-", "\_"                                                                                               |
-+| `branch_type.enable`            | If enabled include type                                                                                                                   |
-+| `branch_type.separator`         | Branch delimeter - "/" (default), "-", "\_"                                                                                               |
-+| `branch_ticket.enable`          | If enabled include ticket                                                                                                                 |
-+| `branch_ticket.required`        | If enabled require ticket                                                                                                                 |
-+| `branch_ticket.separator`       | Branch delimeter - "/", "-" (default), "\_"                                                                                               |
-+| `branch_description.max_length` | Max length branch name                                                                                                                    |
-+| `branch_description.separator`  | Branch delimeter - "" (default), "/", "-", "\_"                                                                                           |
-+| `branch_version.enable`         | If enabled include version                                                                                                                |
-+| `branch_version.required`       | If enabled require version                                                                                                                |
-+| `branch_version.separator`      | Branch delimeter - "", "/" (default), "-", "\_"                                                                                           |
-+| `branch_order`                  | Order of branch name values (doesn't effect prompt order)                                                                                 |
-+| `branch_action_default`         | "branch" or "worktree"                                                                                                                    |
-+| `enable_worktrees`              | `Deprecated` see `worktrees.enable`                                                                                                       |
-+| `worktrees.enable`              | If false, always default to branch action                                                                                                 |
-+| `worktrees.base_path`           | Directory where worktrees are created (default: "..")                                                                                     |
-+| `worktrees.folder_template`     | Template for worktree folder names with variables like {{repo_name}}, {{branch_description}}, {{user}}, {{type}}, {{ticket}}, {{version}} |
- 
- </details>
- 
-@@ -368,16 +368,13 @@ Branch configuration (same config file, split for readability)
- 
- ## 🌳 Better Branch
- 
--> [!NOTE]<br>
--> Using `better-branch` with `better-commits` can supercharge your git workflow.
--> Make sure to try it out!
--
- Better branch is a secondary feature that works with better commits
- 
- - Supports consistent branch naming conventions
- - Uses same type-list/prompt from your config
- - Enables better-commits to infer type & ticket
- - Caches your username for speedy branching
-+- Convenient worktree creation
- 
- To run the CLI in your terminal:
- 
-@@ -387,13 +384,14 @@ better-branch
- 
- ### Worktree Support
- 
--`better-branch` will prompt for **Branch** or **Worktree**. Creating a **Worktree** with `better-branch` is a great way to create worktrees while maintaining consistent branch naming conventions.
--
--The worktree flow creates a folder/worktree with your **branch description** and a git branch inside with your **full branch name**.
-+`better-branch` will prompt for **Branch** or **Worktree**. The Worktree flow creates a folder/worktree from your **branch description** and a git branch inside with your **full branch name**.
- 
- > [!NOTE]<br>
- > Creating a worktree named `everduin94/feat/TAC-123-add-worktrees` with the native git command would create a nested folder for each `/`. `better-branch` removes the hassle by creating 1 folder while still using the full name for the branch.
- 
-+> [!TIP]
-+> By default, `better-branch` will create **worktrees** as a sibling folder. To change this, see `worktrees.base_path`.
-+
- ### Pre/Post Branch Checkout Hooks
- 
- Optionally configure pre and post checkout commands, for example:
-@@ -425,7 +423,7 @@ If you're using Github issues to track your work, and select the `closes` footer
- 
- `better-commits` can append a commit trailer per commit type. This allows you to [automate change logs](https://docs.gitlab.com/ee/user/project/changelogs.html) with tools like Gitlab.
- 
--### Fun Facts
-+### Misc
- 
- `better-commits` uses native `git` commands under the hood. So any hooks, tools, or staging should work as if it was a normal commit.
- 
-@@ -434,9 +432,6 @@ Setting `confirm_with_editor=true` will allow you to edit/confirm a commit with
- - For example, to edit with Neovim: `git config --global core.editor "nvim"`
- - For VS Code, `git config --global core.editor "code -n --wait"`
- 
--> [!NOTE]<br>
--> Enjoy learning, open source technology, and note-taking? [Join our Discord!](https://discord.gg/grHVnZwYup)
--
- You can add this badge to your repository to display that you're using a better-commits repository config
- 
- | Markdown                                                                                                                                                                                                          | Result                                                                                                                                                                                                          |
-diff --git a/src/branch.ts b/src/branch.ts
-index 14b3f0f..bd70311 100644
---- a/src/branch.ts
-+++ b/src/branch.ts
-@@ -17,7 +17,7 @@ import {
-   CACHE_PROMPT,
-   OPTIONAL_PROMPT,
-   load_setup,
--  get_repo_name,
-+  get_git_root,
- } from "./utils";
- import { flags } from "./args";
- 
-@@ -25,9 +25,10 @@ main(load_setup(" better-branch "));
- 
- async function main(config: Output<typeof Config>) {
-   const branch_state = parse(BranchState, {});
-+  chdir(get_git_root());
- 
-   let checkout_type: Output<typeof V_BRANCH_ACTIONS> = "branch";
--  if (config.enable_worktrees) {
-+  if (config.worktrees.enable) {
-     const branch_or_worktree = await p.select({
-       message: `Checkout a branch or create a worktree?`,
-       initialValue: config.branch_action_default,
-@@ -198,26 +199,26 @@ function build_worktree_path(
-   branch_state: Output<typeof BranchState>,
-   config: Output<typeof Config>,
- ): string {
--  const repo_name = get_repo_name();
--  let worktree_name = config.worktree_config.folder_template;
--  
--  // Replace template variables
-+  const gitRoot = get_git_root();
-+  const repo_name = gitRoot.split("/").pop() || "repo";
-+
-+  let worktree_name = config.worktrees.folder_template;
-+
-   worktree_name = worktree_name
--    .replace(/\{\{repo_name\}\}/g, repo_name)
--    .replace(/\{\{branch_description\}\}/g, branch_state.description)
--    .replace(/\{\{user\}\}/g, branch_state.user || "")
--    .replace(/\{\{type\}\}/g, branch_state.type || "")
--    .replace(/\{\{ticket\}\}/g, branch_state.ticket || "")
--    .replace(/\{\{version\}\}/g, branch_state.version || "");
--  
--  // Clean up any double hyphens or leading/trailing hyphens
-+    .replace("{{repo_name}}", repo_name)
-+    .replace("{{branch_description}}", branch_state.description)
-+    .replace("{{user}}", branch_state.user || "")
-+    .replace("{{type}}", branch_state.type || "")
-+    .replace("{{ticket}}", branch_state.ticket || "")
-+    .replace("{{version}}", branch_state.version || "");
-+
-   worktree_name = worktree_name
-+    .replace(/\s/g, "")
-     .replace(/--+/g, "-")
-     .replace(/^-+|-+$/g, "");
--  
--  // Combine with base path
--  const base_path = config.worktree_config.base_path;
--  return `${base_path}${base_path.endsWith('/') ? '' : '/'}${worktree_name}`;
-+
-+  const base_path = config.worktrees.base_path;
-+  return `${base_path}${base_path.endsWith("/") ? "" : "/"}${worktree_name}`;
- }
- 
- function get_user_from_cache(): string {
-diff --git a/src/utils.ts b/src/utils.ts
-index 7166c2a..0c0403d 100644
---- a/src/utils.ts
-+++ b/src/utils.ts
-@@ -224,29 +224,3 @@ export function set_value_cache(
-     );
-   }
- }
--
--export function get_repo_name(): string {
--  try {
--    // First try to get repo name from git remote
--    const remote = execSync(`git ${flags.git_args} remote get-url origin`, {
--      stdio: "pipe",
--    }).toString().trim();
--    
--    // Extract repo name from remote URL
--    const match = remote.match(/\/([^\/]+?)(\.git)?$/);
--    if (match && match[1]) {
--      return match[1];
--    }
--  } catch (err) {
--    // If git remote fails, fall back to directory name
--  }
--  
--  try {
--    // Fall back to git root directory name
--    const gitRoot = get_git_root();
--    const repoName = gitRoot.split('/').pop() || 'repo';
--    return repoName;
--  } catch (err) {
--    return 'repo';
--  }
--}
-diff --git a/src/valibot-state.ts b/src/valibot-state.ts
-index 7256ca3..de943a3 100644
---- a/src/valibot-state.ts
-+++ b/src/valibot-state.ts
-@@ -211,15 +211,16 @@ export const Config = v.object({
-   branch_action_default: v.optional(V_BRANCH_ACTIONS, "branch"),
-   branch_order: v.optional(v.array(V_BRANCH_FIELDS), BRANCH_ORDER_DEFAULTS),
-   enable_worktrees: v.optional(v.boolean(), true),
--  worktree_config: v.optional(
-+  worktrees: v.optional(
-     v.object({
--      base_path: v.optional(v.string(), "../"),
--      folder_template: v.optional(v.string(), "{{repo_name}}-{{branch_description}}"),
-+      enable: v.optional(v.boolean(), true),
-+      base_path: v.optional(v.string(), ".."),
-+      folder_template: v.optional(
-+        v.string(),
-+        "{{repo_name}}-{{ticket}}-{{branch_description}}",
-+      ),
-     }),
--    {
--      base_path: "../",
--      folder_template: "{{repo_name}}-{{branch_description}}",
--    },
-+    {},
-   ),
-   overrides: v.optional(
-     v.object({
--- 
-2.39.5 (Apple Git-154)
-

package/docs/ai-skills.yaml

@@ -1,48 +0,0 @@
-program: better-commits
-version: 1
-rules:
-  - prefer_non_interactive: true
-  - always_dry_run_first: true
-  - config_precedence: repo_then_home
-  - repo_config_path: .better-commits.json
-  - home_config_path: ~/.better-commits.json
-
-skills:
-  - id: create_commit_non_interactive
-    goal: Create a commit without prompts using CLI flags.
-    command: better-commits --no-interactive [flags]
-    required_flags:
-      - --title
-    optional_flags:
-      - --type
-      - --scope
-      - --body
-      - --ticket
-      - --closes
-      - --trailer
-      - --breaking-title
-      - --breaking-body
-      - --deprecates-title
-      - --deprecates-body
-      - --custom-footer
-    inference:
-      - If --type is missing, infer from branch when possible.
-      - If --ticket is missing, infer from branch when possible.
-    flow:
-      - Run dry-run first.
-      - If valid, rerun without --dry-run.
-    dry_run_example: better-commits --no-interactive --dry-run --title "add parser"
-    commit_example: better-commits --no-interactive --type feat --title "add parser"
-
-  - id: edit_config_interview
-    goal: Create or update .better-commits.json based on user preferences and verify it.
-    flow:
-      - Choose target config: repo .better-commits.json, else ~/.better-commits.json.
-      - If repo config is needed and missing, run better-commits-init in repo root.
-      - Ask focused questions and edit JSON only.
-      - Preserve unknown keys.
-      - Validate with a dry-run commit command.
-    validation_command: better-commits --no-interactive --dry-run --type feat --title "config validation"
-    success_criteria:
-      - command exits successfully
-      - no schema or config validation errors

package/docs/clack.md

@@ -1,143 +0,0 @@
-# Clack Usage
-
-`better-commits` uses [`@clack/prompts`](https://github.com/natemoo-re/clack) as its sole interactive UI layer. All terminal prompts, logging, and banners go through clack — there is no `readline`, `inquirer`, or other prompt library in use.
-
-## Packages
-
-| Package          | Version  | Role                                                   |
-| ---------------- | -------- | ------------------------------------------------------ |
-| `@clack/prompts` | `^0.7.0` | Directly imported in all source files                  |
-| `@clack/core`    | `^0.3.1` | Peer dependency of `@clack/prompts`, used transitively |
-
-All files import clack with the alias:
-
-```ts
-import * as p from "@clack/prompts";
-```
-
-## Files That Use Clack
-
-- `src/index.ts` — main `better-commits` CLI flow
-- `src/branch.ts` — `better-branch` CLI flow
-- `src/utils.ts` — config loading and setup
-- `src/git.ts` — git operation feedback
-- `src/init.ts` — config initialization
-
-## API Reference
-
-### `p.intro(message)`
-
-Renders a styled banner at the start of each CLI entrypoint.
-
-```ts
-// src/utils.ts
-p.intro(color.bgCyan(color.black(cli_name)));
-
-// src/init.ts
-p.intro(color.bgCyan(color.black(" better-commits-init ")));
-```
-
-### `p.outro(message)`
-
-Renders a closing message at the end of a CLI flow. Only used in `src/init.ts` after writing the config file.
-
-```ts
-p.outro("Run better-commits to start the CLI");
-```
-
-### `p.note(message, title)`
-
-Prints a multi-line boxed panel. Used in `src/index.ts` to display a formatted commit preview before confirmation.
-
-```ts
-p.note(commit_string, "Commit Preview");
-```
-
-### `p.select(options)`
-
-Single-selection list prompt. Used for:
-
-| Location        | Prompt                                    |
-| --------------- | ----------------------------------------- |
-| `src/index.ts`  | "Select a commit type"                    |
-| `src/index.ts`  | "Select a commit scope"                   |
-| `src/branch.ts` | "Checkout a branch or create a worktree?" |
-| `src/branch.ts` | "Select a branch type"                    |
-
-### `p.multiselect(options)`
-
-Multi-selection checkbox prompt. Used for:
-
-| Location       | Prompt                                                                           |
-| -------------- | -------------------------------------------------------------------------------- |
-| `src/index.ts` | "would you like to add them now?" — lists unstaged files                         |
-| `src/index.ts` | "Select optional footers" — closes, trailer, breaking-change, deprecated, custom |
-
-The footers prompt uses `required: false` to make it skippable.
-
-### `p.text(options)`
-
-Free-text input with optional `validate` and `initialValue`. Used across 15+ prompts, including:
-
-| Location        | Prompt                                                             |
-| --------------- | ------------------------------------------------------------------ |
-| `src/index.ts`  | "Write a custom scope"                                             |
-| `src/index.ts`  | "Add ticket / issue" (pre-filled from branch name inference)       |
-| `src/index.ts`  | "Write a brief title describing the commit" (validates `max_size`) |
-| `src/index.ts`  | "Write a detailed description of the changes"                      |
-| `src/index.ts`  | "Breaking changes: Write a short title / summary"                  |
-| `src/index.ts`  | "Breaking Changes: Write a description & migration instructions"   |
-| `src/index.ts`  | "Deprecated: Write a short title / summary"                        |
-| `src/index.ts`  | "Deprecated: Write a description"                                  |
-| `src/index.ts`  | "Write a custom footer"                                            |
-| `src/branch.ts` | "Type your git username"                                           |
-| `src/branch.ts` | "Type ticket / issue number"                                       |
-| `src/branch.ts` | "Type version number"                                              |
-| `src/branch.ts` | "Type a short description" (enforces `max_length`)                 |
-
-### `p.confirm(options)`
-
-Yes/No confirmation prompt. Used once in `src/index.ts`:
-
-```ts
-const confirmed = await p.confirm({ message: "Confirm Commit?" });
-```
-
-Only shown when `config.confirm_commit` is `true`. The boolean result controls whether the git commit executes.
-
-### `p.isCancel(value)`
-
-Checks if the user cancelled a prompt (via `Ctrl+C`). Called immediately after **every** prompt throughout the codebase. On cancel, `process.exit(0)` is called for a graceful exit.
-
-- Called **19 times** in `src/index.ts`
-- Called **7 times** in `src/branch.ts`
-
-Pattern used throughout:
-
-```ts
-const value = await p.text({ message: "..." });
-if (p.isCancel(value)) process.exit(0);
-```
-
-### `p.log.*`
-
-Structured log functions used in place of `console.log` across all files.
-
-| Method               | Color   | Usage                                                                         |
-| -------------------- | ------- | ----------------------------------------------------------------------------- |
-| `p.log.step(msg)`    | neutral | Info messages: "Found global config", "Checking Git Status"                   |
-| `p.log.success(msg)` | green   | "Commit Complete", "Successfully created .better-commits.json"                |
-| `p.log.error(msg)`   | red     | Failed git commands, invalid config, failed staging                           |
-| `p.log.warn(msg)`    | yellow  | Missing git root, cache failures, invalid config paths                        |
-| `p.log.warning(msg)` | yellow  | Alias for `warn`; used once in `src/branch.ts` for duplicate branch detection |
-| `p.log.info(msg)`    | blue    | "Committing changes...", "Exiting without commit", branch creation success    |
-
-## CLI Interaction Flow
-
-Every CLI command follows this structure:
-
-1. `p.intro()` — welcome banner
-2. Series of `p.select` / `p.multiselect` / `p.text` / `p.confirm` prompts, each immediately guarded by `p.isCancel()`
-3. `p.log.*` — structured feedback at each meaningful step (config loading, git operations, errors)
-4. `p.note()` — optional formatted commit preview before final confirmation (`src/index.ts` only)
-5. `p.outro()` — closing message (`src/init.ts` only; main flows end with `p.log.success`)