bunset 0.0.2 → 0.0.3

package/README.md

@@ -33,11 +33,12 @@ bunset [options]
 | `--all` | Update all workspace packages |
 | `--changed` | Update only changed packages (default for workspaces) |
 | `--no-commit` | Do not commit changes to git (commits by default) |
-| `--tag` | Tag the commit with new version (default) |
+| `--no-tag` | Tag the commit with new version (default) |
 | `--per-package-tags` | Use `pkg@1.2.3` tags instead of prefixed tags |
-| `--tag-prefix` | Tag prefix (default: `v`, e.g. `v1.2.3`) |
+| `--tag-prefix` | Tag prefix (auto-detected from last tag, or `v` if no tags) |
 | `--sections` | Comma-separated changelog sections (default: `feat,fix,perf`) |
 | `--dry-run` | Preview changes without writing files, committing, or tagging |
+| `--debug` | Show detailed inclusion/exclusion reasoning (implies `--dry-run`) |
 | `--no-filter-by-package` | Include all commits in every package changelog (monorepo) |
 
 When bump type or scope flags are omitted, interactive prompts will ask.
@@ -87,21 +88,33 @@ Only sections listed in `--sections` (or the `sections` config option) appear in
 
 ### Config File
 
-Place a `.bunset.toml` in your project root to set persistent defaults so you don't have to pass the same flags every time:
+Place a `.bunset.toml` in your project root to set persistent defaults so you don't have to pass the same flags every time. All fields are optional. CLI flags always take priority over config values.
 
 ```toml
-bump = "patch"                              # "patch" | "minor" | "major"
-scope = "changed"                           # "all" | "changed"
-commit = true
-tag = true
-per-package-tags = false
-sections = ["feat", "fix", "perf"]          # changelog sections and order
-dry-run = false                             # preview without writing
-filter-by-package = true                    # per-package commit filtering (monorepo)
-tag-prefix = "v"                            # prefix for version tags
+bump = "patch"                          # "patch" | "minor" | "major"
+scope = "changed"                       # "all" | "changed"
+commit = true                           # auto-commit (default: true)
+tag = true                              # create git tags (default: true)
+per-package-tags = false                # pkg@version tags (monorepo)
+tag-prefix = "v"                        # tag prefix (default: auto-detect)
+sections = ["feat", "fix", "perf"]      # changelog sections and order
+dry-run = false                         # preview without writing
+debug = false                           # detailed reasoning (implies dry-run)
+filter-by-package = true                # per-package filtering (monorepo)
 ```
 
-All fields are optional. CLI flags always take priority over config values. If `bump` or `scope` is set in config, the interactive prompt for that option is skipped.
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `bump` | `string` | _(prompt)_ | Version bump type: `"patch"`, `"minor"`, or `"major"`. Skips the interactive prompt when set. |
+| `scope` | `string` | _(prompt)_ | Package scope: `"all"` or `"changed"`. Skips the interactive prompt when set (monorepo only). |
+| `commit` | `boolean` | `true` | Whether to auto-commit the version bump and changelog changes. |
+| `tag` | `boolean` | `true` | Whether to create git tags for released versions. |
+| `per-package-tags` | `boolean` | `false` | Use `pkg@1.2.3` tags instead of prefixed tags. In a monorepo, packages with no matching commits are skipped entirely. |
+| `tag-prefix` | `string` | _(auto)_ | Prefix for version tags. Auto-detected from the last git tag when not set (falls back to `"v"` if no tags exist). Set to `""` for bare version numbers, or e.g. `"project-v"` for `project-v1.2.3`. |
+| `sections` | `string[]` | `["feat", "fix", "perf"]` | Which commit types to include in the changelog and in what order. Accepts any recognized type keyword. |
+| `dry-run` | `boolean` | `false` | Preview all changes without writing files, committing, or tagging. |
+| `debug` | `boolean` | `false` | Show detailed inclusion/exclusion reasoning. Implies `dry-run`. |
+| `filter-by-package` | `boolean` | `true` | In a monorepo, only include commits that touched files within each package. Disable with `false` to include all commits in every changelog. |
 
 ## Testing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunset",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "module": "src/index.ts",
   "type": "module",
   "bin": {

package/src/cli.ts

@@ -16,9 +16,10 @@ Options:
   --no-commit          Do not commit the version bump and changelog
   --no-tag             Do not create git tags for released versions
   --per-package-tags   Use package-scoped tags (pkg@version) instead of prefixed
-  --tag-prefix <str>   Tag prefix (default: "v", e.g. v1.2.3)
+  --tag-prefix <str>   Tag prefix (auto-detected from last tag, or "v" if no tags)
   --sections <list>    Comma-separated changelog sections (default: feat,fix,perf)
   --dry-run            Preview changes without writing files, committing, or tagging
+  --debug              Show detailed inclusion/exclusion reasoning (implies --dry-run)
   --no-filter-by-package
                        Include all commits in every package changelog (monorepo)
   --help, -h           Show this help message
@@ -50,9 +51,21 @@ Commit format:
   Only sections listed in --sections (or config) are included in the changelog.
   Default sections: feat, fix, perf.
 
-Config:
+Config file (.bunset.toml):
   Place a .bunset.toml in your project root to set persistent defaults.
-  CLI flags always override config values. See README for format.`);
+  All fields are optional. CLI flags always override config values.
+
+  Example:
+    bump = "patch"                          # "patch" | "minor" | "major"
+    scope = "changed"                       # "all" | "changed"
+    commit = true                           # auto-commit (default: true)
+    tag = true                              # create git tags (default: true)
+    per-package-tags = false                # pkg@version tags (monorepo)
+    tag-prefix = "v"                        # tag prefix (default: auto-detect)
+    sections = ["feat", "fix", "perf"]      # changelog sections and order
+    dry-run = false                         # preview without writing
+    debug = false                           # detailed reasoning (implies dry-run)
+    filter-by-package = true                # per-package filtering (monorepo)`);
 }
 
 export function resolveOptions(
@@ -74,6 +87,7 @@ export function resolveOptions(
       "dry-run": { type: "boolean", default: false },
       "filter-by-package": { type: "boolean", default: true },
       "tag-prefix": { type: "string" },
+      debug: { type: "boolean", default: false },
       help: { type: "boolean", short: "h", default: false },
     },
     strict: true,
@@ -100,7 +114,8 @@ export function resolveOptions(
     ?? config.sections
     ?? DEFAULT_SECTIONS;
 
-  const dryRun = values["dry-run"] ? true : (config.dryRun ?? false);
+  const debug = values.debug ? true : (config.debug ?? false);
+  const dryRun = debug || values["dry-run"] ? true : (config.dryRun ?? false);
 
   const filterByPackage = values["filter-by-package"] === false
     ? false
@@ -108,14 +123,14 @@ export function resolveOptions(
 
   const tagPrefix = values["tag-prefix"] as string | undefined
     ?? config.tagPrefix
-    ?? "v";
+    ?? null;
 
   if (bump && scope) {
-    return { scope, bump, commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix };
+    return { scope, bump, commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix, debug };
   }
 
   return promptForMissing(
-    { commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix },
+    { commit, tag, perPackageTags, sections, dryRun, filterByPackage, tagPrefix, debug },
     bump,
     scope,
     isWs,
@@ -156,7 +171,8 @@ interface MergedDefaults {
   sections: CommitType[];
   dryRun: boolean;
   filterByPackage: boolean;
-  tagPrefix: string;
+  tagPrefix: string | null;
+  debug: boolean;
 }
 
 async function promptForMissing(

package/src/config.ts

@@ -49,6 +49,10 @@ export async function loadConfig(
     config.tagPrefix = raw["tag-prefix"];
   }
 
+  if (typeof raw.debug === "boolean") {
+    config.debug = raw.debug;
+  }
+
   if (Array.isArray(raw.sections)) {
     const sections: CommitType[] = [];
     for (const s of raw.sections) {

package/src/index.ts

@@ -29,10 +29,41 @@ const isWs = await isWorkspace(cwd);
 const config = await loadConfig(cwd);
 const options = await resolveOptions(isWs, config);
 
+const dbg = options.debug;
+function debug(msg: string): void {
+  if (dbg) console.log(`[debug] ${msg}`);
+}
+
+if (dbg) {
+  console.log("--- Debug Mode (dry-run implied) ---\n");
+  debug(`cwd: ${cwd}`);
+  debug(`workspace: ${isWs}`);
+  debug(`config loaded: ${JSON.stringify(config)}`);
+  debug(`resolved options: ${JSON.stringify(options)}`);
+  console.log("");
+}
+
 const allPackages = await getAllPackages(cwd);
 const lastTag = await getLastTag(cwd);
 const rawCommits = await getCommitsSince(cwd, lastTag);
 
+// Resolve tagPrefix: explicit value wins, otherwise infer from last tag
+let tagPrefix: string;
+if (options.tagPrefix !== null) {
+  tagPrefix = options.tagPrefix;
+  debug(`tag prefix explicit: "${tagPrefix}"`);
+} else if (lastTag) {
+  const semverMatch = lastTag.match(/\d+\.\d+\.\d+/);
+  tagPrefix = semverMatch ? lastTag.slice(0, semverMatch.index) : "v";
+  debug(`tag prefix auto-detected: "${tagPrefix}" (from tag: ${lastTag})`);
+} else {
+  tagPrefix = "v";
+  debug(`tag prefix default: "${tagPrefix}" (no previous tags found)`);
+}
+
+debug(`last tag: ${lastTag ?? "(none)"}`);
+debug(`raw commits since tag: ${rawCommits.length}`);
+
 if (rawCommits.length === 0) {
   console.log("No commits found since last tag. Nothing to do.");
   process.exit(0);
@@ -40,14 +71,33 @@ if (rawCommits.length === 0) {
 
 const parsed = rawCommits.map((c) => parseCommit(c.hash, c.message));
 
+if (dbg) {
+  console.log("");
+  debug("--- Parsed commits ---");
+  for (const c of parsed) {
+    const typeStr = c.type ?? "UNRECOGNIZED";
+    const scopeStr = c.commitScope ? `(${c.commitScope})` : "";
+    const included = c.type && options.sections.includes(c.type) ? "INCLUDED" : "EXCLUDED";
+    debug(`  ${c.hash.slice(0, 7)} ${typeStr}${scopeStr}: ${c.description} → ${included} (section: ${c.type ?? "none"})`);
+  }
+  console.log("");
+}
+
 // In a monorepo with filtering, fetch the file list for each commit
 const shouldFilter = isWs && options.filterByPackage;
+debug(`per-package filtering: ${shouldFilter ? "enabled" : "disabled"}`);
 if (shouldFilter) {
   await Promise.all(
     parsed.map(async (commit) => {
       commit.files = await getCommitFiles(cwd, commit.hash);
     }),
   );
+  if (dbg) {
+    for (const c of parsed) {
+      debug(`  ${c.hash.slice(0, 7)} files: ${c.files.length > 0 ? c.files.join(", ") : "(none)"}`);
+    }
+    console.log("");
+  }
 }
 
 const globalGroups = groupCommits(parsed);
@@ -62,6 +112,8 @@ let packages =
     ? await getChangedPackages(cwd, allPackages, lastTag)
     : allPackages;
 
+debug(`scope: ${options.scope}, packages to process: ${packages.map((p) => p.name).join(", ") || "(none)"}`);
+
 if (packages.length === 0) {
   console.log("No changed packages found. Nothing to do.");
   process.exit(0);
@@ -81,7 +133,7 @@ function packageHasChanges(groups: GroupedCommits): boolean {
 }
 
 if (options.dryRun) {
-  console.log("--- Dry Run ---\n");
+  if (!dbg) console.log("--- Dry Run ---\n");
 
   const tags: string[] = [];
 
@@ -89,6 +141,24 @@ if (options.dryRun) {
     const groups = getPackageGroups(pkg, parsed);
     const hasChanges = packageHasChanges(groups);
 
+    if (dbg) {
+      debug(`--- Package: ${pkg.name} ---`);
+      debug(`  path: ${pkg.path}`);
+      debug(`  current version: ${pkg.version ?? "0.0.0"}`);
+      for (const section of options.sections) {
+        const commits = groups[section];
+        if (commits.length > 0) {
+          debug(`  ${section}: ${commits.length} commit(s)`);
+          for (const c of commits) {
+            debug(`    - ${c.hash.slice(0, 7)} ${c.description}${c.commitScope ? ` (scope: ${c.commitScope})` : ""}`);
+          }
+        } else {
+          debug(`  ${section}: 0 commits`);
+        }
+      }
+      debug(`  has matching commits: ${hasChanges}`);
+    }
+
     if (!hasChanges && options.perPackageTags) {
       console.log(`${pkg.name}: no matching commits, skipping.`);
       continue;
@@ -117,7 +187,7 @@ if (options.dryRun) {
       if (options.perPackageTags) {
         tags.push(`${pkg.name}@${newVersion}`);
       } else {
-        tags.push(`${options.tagPrefix}${newVersion}`);
+        tags.push(`${tagPrefix}${newVersion}`);
       }
     }
   }
@@ -177,7 +247,7 @@ for (const pkg of packages) {
     if (options.perPackageTags) {
       tags.push(`${pkg.name}@${newVersion}`);
     } else {
-      tags.push(`${options.tagPrefix}${newVersion}`);
+      tags.push(`${tagPrefix}${newVersion}`);
     }
   }
 }

package/src/types.ts

@@ -21,7 +21,8 @@ export interface CliOptions {
   sections: CommitType[];
   dryRun: boolean;
   filterByPackage: boolean;
-  tagPrefix: string;
+  tagPrefix: string | null;
+  debug: boolean;
 }
 
 export interface ParsedCommit {